home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / Add-Ons / MacsBug / Grabbug 1.0b2 / Read Me About Grabbug < prev   
Text File  |  1995-08-24  |  7KB  |  60 lines

  1. Read Me About Grabbug
  2.  
  3. Grabbug is a utility for grabbing screen dumps. Grabbug is hard to use, consumes lots of memory and doesn’t have many advanced features. Its sole redeeming feature is that it can grab the screen at any time, even interrupt time.  Cool huh?
  4.  
  5. Salient features:
  6.  
  7. • MacsBug dcmd for grabbing
  8. • Application for dumping grabs.
  9. • Requires System 7.5 or later.
  10. • Requires MacsBug 6.5d10 or later.
  11. • Source code included.
  12.  
  13. Background Information
  14.  
  15. Grabbug was written because I had a hard time capturing zoom rects. I was writing a web page on some of the more subtle features of the Macintosh human interface and I wanted to grab them in action. Unfortunately neither the Macintosh built-in screen capture utility nor the Flash-It (which I highly recommend by the way) can capture the screen in the middle of a zoom rectangle sequence. I then went searching on the net and found the Snapz utility. This claimed to be able to grab the screen at any time, including in the middle of arcade games that don’t give time to other processes. Unfortunately Snapz, while it was most probably capable of grabbing the zoom rects, didn’t have the temporal precision to grab something as ephemeral as a zoom rect.
  16.  
  17. I needed bigger guns!
  18.  
  19. Grabbug is a two part solution to this problem. The first part is a MacsBug plug-in (known as a 'dcmd', or debugger command) that loads at startup time and allocates the a temporary buffer that stores the screen dump. When you invoke this dcmd from MacsBug it captures the screen to the temporary buffer. The second part of Grabbug is a little application called “Grabbug Dump”. When you run this it dumps the most recent screen dump to a file in the root directory of your boot disk.
  20.  
  21. btw The web page in question is at:
  22.  
  23.   <http://redback.cs.uwa.edu.au/Quinn/WWW/Ideology/HumanInterfaceSubtleties.html>
  24.  
  25. Installation and Use
  26.  
  27. As mentioned earlier, Grabbug is not particularly easy to install and use. The steps required to use Grabbug are:
  28.  
  29. 0. Make sure you’re running System 7.5. This won’t work on earlier systems.
  30. 1. Install MacsBug 6.5d10 or greater.
  31. 2. Use ResEdit to copy the Grabbug dcmd to your Debugger Prefs and restart.
  32. 3. Drop into MacsBug when you want to take a screen shot and run the Grabbug dcmd.
  33. 4. Leave MacsBug and continue operations.
  34. 5. When it’s convenient, run the Grabbug Dump application.
  35.  
  36. The following sections cover these steps in greater detail.
  37.  
  38. 1. Install MacsBug
  39.  
  40. Skip this step if you have MacsBug 6.5d10 or greater installed.
  41.  
  42. MacsBug is a low-level debugger that’s freely available from Apple. You can get it from: 
  43.  
  44.   ftp://ftp.support.apple.com/pub/apple_sw_updates/US/Macintosh/Utilities/
  45.  
  46. When you get the package you will find a file called “MacsBug”. Put this file in your System Folder (not in the Extensions folder!) and restart. When you restart you’re Mac should say “Debugger Installed” shortly after saying “Welcome to Macintosh”.
  47.  
  48. 2. Use ResEdit to Install the dcmd
  49.  
  50. In the Grabbug distribution there is a resource file called “Grabbug”. Inside that file is a 'dcmd' resource also called “Grabbug”.
  51.  
  52. If you also have a Debugger Prefs file, simply use ResEdit (also available at the location given above) to copy the Grabbug dcmd into your Debugger Prefs file. It’s safe to renumber it if its ID clashes with an existing dcmd.
  53.  
  54. If you don’t have a Debugger Prefs file you should use ResEdit to create one in your System Folder (not in the Preferences folder!) and call it “Debugger Prefs” (use that name exactly). You can then copy the Grabbug dcmd into your newly created file.
  55.  
  56. 3. Drop into MacsBug and Run Grabbug
  57.  
  58. When you want to take a screen shot drop into MacsBug and type Grabbug.  Grabbug will respond with Snap! to let you know that it has grabbed the screen shot.
  59.  
  60. You can drop into MacsBug in a variety of ways. The most obvious is to hit the Mac’s Interrupt button, usually on the front of the machine near the Reset button. [Don’t mix them up!] Alternatively many Macs support the command-power combination to enter MacsBug. Finally you can use all your programming skill to set MacsBug break